<?xml version="1.0" encoding="UTF-8"?>
<section>
  <title>KAGeXpress的扩展功能</title>

  <section>
    <title>button (扩展)</title>

    <para>给按钮增加了对动画(animation)的支持。</para>

    <para>这个按钮层无法完全替代ButtonLayer，它的内部工作机制和ButtonLayer是不同的。它提供了ButtonLayer中没有的某些功能，但是并不包含ButtonLayer中原有的全部功能(不包含文字描绘等)。</para>

    <para>该按钮图层要求载入.asd文件连同图片一起载入。在.asd文件中包含normal, over, on,
    focus这几个label，至少也要有normal。</para>

    <para><table>
        <title>button的扩展属性</title>

        <tgroup cols="3">
          <tbody>
            <row>
              <entry>属性名称</entry>

              <entry>是否必须</entry>

              <entry>说明</entry>
            </row>

            <row>
              <entry>anigraphic</entry>

              <entry>否</entry>

              <entry>对应动画脚本的图片文件名 指定这个参数即认定该按钮为动画按钮，graphic和normal, over, on,
              focus都会被忽略</entry>
            </row>

            <row>
              <entry>anim</entry>

              <entry>否</entry>

              <entry>动画脚本文件名，不指定则按语图片文件同名来处理</entry>
            </row>

            <row>
              <entry>clipleft</entry>

              <entry>否</entry>

              <entry>clip矩形的左边界的横坐标</entry>
            </row>

            <row>
              <entry>cliptop</entry>

              <entry>否</entry>

              <entry>clip矩形的上边界的纵坐标</entry>
            </row>

            <row>
              <entry>clipwidth</entry>

              <entry>否</entry>

              <entry>clip矩形的宽</entry>
            </row>

            <row>
              <entry>clipheight</entry>

              <entry>否</entry>

              <entry>clip矩形的高</entry>
            </row>
          </tbody>
        </tgroup>
      </table>同时支持image这个tag中的某些参数</para>
  </section>

  <section>
    <title>sysbutton (扩展)</title>

    <para>同上</para>
  </section>

  <section>
    <title>settexttransoption (新增)</title>

    <para>针对文字的trans功能。该tag用于设置文字渐变的形式，所需参数和trans的参数类似。</para>

    <para>文字渐变功能会以一个文字为单位进行渐变操作，如果用ch同时输出多个文字，则会将同时输出的多个文字作为一个整体进行渐变。</para>

    <para><table>
        <title>settexttransoption的扩展属性</title>

        <tgroup cols="3">
          <tbody>
            <row>
              <entry>属性名称</entry>

              <entry>是否必须</entry>

              <entry>说明</entry>
            </row>

            <row>
              <entry>layer 和 page</entry>

              <entry>否</entry>

              <entry>指定目标文字层，不指定则默认为当前层</entry>
            </row>

            <row>
              <entry>method</entry>

              <entry>否</entry>

              <entry>渐变操作的类型，设为“disabled”代表不使用文字渐变功能，默认为“disabled”</entry>
            </row>

            <row>
              <entry>time</entry>

              <entry>否</entry>

              <entry>文字渐变的时间，设为0代表使用文字delay时间作为渐变时间，默认为0</entry>
            </row>

            <row>
              <entry>各个渐变类型的其他相关参数。</entry>

              <entry>否</entry>

              <entry></entry>
            </row>
          </tbody>
        </tgroup>
      </table></para>
  </section>

  <section>
    <title>ptext (扩展)</title>

    <para>可以通过在输出内容中插入“\n”来手动换行。</para>

    <para><table>
        <title>ptext的扩展属性</title>

        <tgroup cols="3">
          <tbody>
            <row>
              <entry>属性名称</entry>

              <entry>是否必须</entry>

              <entry>说明</entry>
            </row>

            <row>
              <entry>lineheight</entry>

              <entry>否</entry>

              <entry>换行时的行高，如果不指定这一参数，则不会手动换行</entry>
            </row>
          </tbody>
        </tgroup>
      </table></para>
  </section>

  <section>
    <title>sysbuttonopt (新增)</title>

    <para>实现sysbutton的状态的设置 暂时只支持一个属性，就是enabled。该属性用来临时禁用和启用sysbutton。</para>

    <para><table>
        <title>settexttransoption的扩展属性</title>

        <tgroup cols="3">
          <tbody>
            <row>
              <entry>属性名称</entry>

              <entry>是否必须</entry>

              <entry>说明</entry>
            </row>

            <row>
              <entry>layer 和 page</entry>

              <entry>否</entry>

              <entry>指定目标文字层，不指定则默认为当前层</entry>
            </row>

            <row>
              <entry>name</entry>

              <entry>否</entry>

              <entry>sysbutton的名字，不指定则对目标文字层的所有sysbutton进行操作</entry>
            </row>

            <row>
              <entry>enabled</entry>

              <entry>否</entry>

              <entry>指定目标按钮是否可用，取值为true或false</entry>
            </row>
          </tbody>
        </tgroup>
      </table></para>
  </section>

  <section>
    <title>setface (新增)</title>

    <para>用于加载头像到文字层上。</para>

    <para>这是个临时tag，因为KAGEX里其实已经内藏了这一功能，只不过目前没做出接口。说不准什么时候KAGEX就会正式把这个功能加进去。</para>

    <para><table>
        <title>setface的扩展属性</title>

        <tgroup cols="3">
          <tbody>
            <row>
              <entry>属性名称</entry>

              <entry>是否必须</entry>

              <entry>说明</entry>
            </row>

            <row>
              <entry>layer 和 page</entry>

              <entry>否</entry>

              <entry>指定目标文字层，不指定则默认为当前层</entry>
            </row>

            <row>
              <entry>storage</entry>

              <entry>是</entry>

              <entry>头像图片文件名 必需参数</entry>
            </row>

            <row>
              <entry>key</entry>

              <entry>否</entry>

              <entry>头像图片的透明色</entry>
            </row>

            <row>
              <entry>left 和 top</entry>

              <entry>否</entry>

              <entry>位置</entry>
            </row>

            <row>
              <entry>width和height</entry>

              <entry>否</entry>

              <entry>尺寸</entry>
            </row>

            <row>
              <entry>absolute</entry>

              <entry>否</entry>

              <entry>深度(前后顺序)</entry>
            </row>

            <row>
              <entry>originMode</entry>

              <entry>坐标修正值(我不知道怎么用这参数)</entry>

              <entry>坐标修正值(我不知道怎么用这参数)</entry>
            </row>
          </tbody>
        </tgroup>
      </table>加载了头像之后，就可以用position 这个tag来修改相关参数，相关属性为
    faceleft，facetop，facewidth，faceheight，faceabsolute，faceorigin，和上面的属性相对应，这个是KAGEX原有的机能。</para>

    <para>文字层擦除操作对头像有效。</para>

    <para></para>
  </section>

  <section>
    <title>对Save/Load的扩展</title>

    <para>增加了Action动作的S/L功能。在Action过程中存档的话，读档后，未完成的Action会继续执行。</para>

    <para></para>
  </section>

  <section>
    <title>新增了记录之前按过的按钮的信息的用户变量</title>

    <para>变量f.lastPressedButton中会记录下之前最后一个被按下(其实是抬起)的按钮的信息。这是个字典，包含如下元素</para>

    <para><table>
        <title>f.lastPressedButton中包含的元素</title>

        <tgroup cols="2">
          <tbody>
            <row>
              <entry>属性名称</entry>

              <entry>说明</entry>
            </row>

            <row>
              <entry>layer 和 page</entry>

              <entry>按钮所在的文字层</entry>
            </row>

            <row>
              <entry>type</entry>

              <entry>按钮类型("button"，"sysbutton"，"anibutton"，"anisysbutton"四种)</entry>
            </row>

            <row>
              <entry>numorname</entry>

              <entry>按钮序号或名字</entry>
            </row>

            <row>
              <entry>time</entry>

              <entry>按下的时间</entry>
            </row>
          </tbody>
        </tgroup>
      </table></para>
  </section>
</section>